Internal Commodore Software required for CDTV 


The next generation CDTV is similar to the current design. 

It consists of an A500 computer with a non-autoconfiging 

memory mapped intelligent peripheral attached. Enhancements 

are added to the current design including the ability for 

the 68000 and the dedicated microprocessor to interrupt each 
other. DMA for the CD-ROM data is provided for in this device as 
well as in the previous. 


Software for the next rev of the CDTV is large in scope. There are 
two basic classes of software that need to be created: 68000 code, 
and dedicated microprocessor code. The 68000 code is device driver 
level & up. Nothing in the 68000 code is required to be real time, 
although the usual performance tradeoffs apply. The dedicated 
microprocessor must deal with all of the real time events, many 

of which are asynchronous. Partial lists of functions to be 
implemented by the two microprocessors are attached. 


The interface between the two microprocessors consists of mutual 
interrupting capability, a dedicated CD-ROM data interface, and 
two unidirectional data paths. 


The interrupt capability allows each machine to interrupt 
the other. 

The CD-ROM DMA interface is much simpler than in the current 
machine. You simply tell it where you want the data go, 

how much data you want to go there, and if you want an 
interrupt when done. ( This is a second interrupt different 
from the that listed above ). 

The 68000 can communicate with the dedicated microprocessor 
via an 8 byte FIFO for commands. The 68000 can must write 
to the dedicated device via byte writes. Data in the 

FIFO interrupts the dedicated microprocessor. The interrupt 
is cleared when the FIFO is empty. 

The dedicated microprocessor can communicate with the 

68000 via an eight bit port. By writing to the port, 

the 68000 is interrupted. This interrupt is cleared by 

a 68000 read of this port. 
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List of tasks for CDTV software 
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68000 code: 

Device driver for CD rom device. volt 

Device driver for CD subcode device. Soeee 

Device driver for dedicated bookmark memory. 

Modifications to higher levels of software. 
dedicated uP code: 

VFD display update & Keypad scan 

- 8 digits/8 segments @ 100 Hz. 

= 6 keys 

IR receive and interpretation ( & keypad interpretation ). 

- Joystick/Mouse/Pot line emulation 

- Genlock Control 

- Soft power switch control 

- Reset of 68000 system 

CD low level control. 

- Laser on/off/focusing 

7 Track stepping/sector searching 

- Spin up/down/PLL locking control 

- Drawer motor control 

> Error Handling 

Audio subsystem control 

- MUTE function. 

- Line & phones level volume function. 

CD-subcode interpretation and ECC. 

- descrambling & deinterleaving of subcode data 

- ECC of subcode data. 

- implementation of software FIFO for system interface. 

Error Handling 

Watchdog timer stroking 

- Regular event not in interrupt routine. 

CD-ROM chip low level control 

- pointer management of dedicated 8kx8 ram. 

- start/stop & error handling for rom ECC conversion. 
- Control of CD-ROM data DMA end interrupts. 
TOC code 
- Read table of contents off of CD. 
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766 West Broadway, STE 204 Glendale, Ca C818) 243-0313 
FAX: (618) 243-7320 


DATE: July 16, 1990 

TO: aes FROM: Reichart Von Wolfsheild 
Commodore Int, Ltd. Silent Software, Inc. 
1200 Wilson Drive 706 W. Broadway, STE 202 
West Chester, PA 19380 Glendale, Calf 91204 
(215) 431-9204 Office (818) 243-0313 Office 
(215) 431-9156 FAX (818) 243-7320 FAX 

RE: Update and overview of all projects 

STATUS: Confidential ee 

Dear Gail, 


Carl called me yesterday and we talked about the status of the 
Commodore contract. As we discussed last Thursday (the 12th) I would 
completely read the contract and be ready to talk Friday or Monday. 
Carl told me on Monday that I should expect a call from Commodore. He 
seemed to be slightly agitated that the agreement had not been 
signed. 


Up until now I had not been under the impression that there was 
anything wrong that could not be worked out between Commodore and SSI. 
However, after my talk with Carl I felt that there was perhaps more 
going on than I originally had perceived. 


On March i8th I sent you a letter which documented some of our 
compression results. These numbers represented the compression ratios 
we had been obtaining for the past year: 


= Here are some general numbers to show compression averages 
on data, these numbers are results of extensive tests: 
TYPE PERCENTAGE DE-COMPRESSOR 
Digitized sound 25-50% 1K 
68000 code 40-50% 240 bytes 
Pictures 40-75% 1K 
Animation (full screen) 40-80% 3K " 


A few days after I sent that letter I took a vested interest in 
researching our optimum capabilities. We were able to bring the size 
of the decompressor itself from a total of about 5K to about 2K. 


; On March 22nd I sent an update letter which gave you further 
numbers and set a price on what I understood at the time to be your 
request for cCDTV. Since this letter we have decreased the 
decompression time by a factor as great as 3. Thus, it is now 3x 
faster, 1/2 the size, and is obtaining high compression ratios. 


On May 9th you sent me a letter that documented our conversations 
from the previous weeks. This letter documented six items from our 
conversation: 


"a. Commodore to acquire non-exclusive rights to software 
decompression code and to "Squeeze Box" compression tools 
for art, sound, code, and random data. 


b. Commodore wants to use decompression tools in ROMs for Baby 
and make tools available to developers free or for a nominal 
fee. 


Cc. Commodore gets source code for above, but Silent Software 
keeps rights, patents, etc. 


da. Payment terms are $10K on signing, $15K on acceptance (60- 
day time limit). 


e. You will offer an animation builder for sale to developers 
for $1000. 


f. You will provide documentation and some developer support." 


I agreed to all six items and henceforth you had a contract 
drafted. I received the contract June 18th and have only been able to 
truly sit down and read it since my return from Dev Con. The 
contract was a bit long (26 pages) considering the type of agreement 
sought by Commodore. I am happy to say that there are only a few 
items that I feel we need to review. Almost all of them deal with 
Appendices A-D. 


It would seem that a clearer breakdown of what I am supplying to 
Commodore is in order. The following is an absolute list of what 
everything is and what it does: 


SBox : (Squeeze Box) A CLI driven command that allows a 
Developer to compress files for use by CDTV. Although 
SBox does not need to know the nature of the files, an 
increased compression ratio is almost guaranteed if 
SBox is informed of the data’s nature due to SBox’s 
special understanding of Picture, Sound, and Binary 

Code formats. (See Exhibit A) ‘ 


DeBox.ROM ; (Decompress Squeeze Box) This is an object file that 
functions exactly like an AmigaDOS library. As a 
matter of fact DeBox.ROM conforms to all standard 
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! AmigaDOS library calls. DeBox.ROM is a 100% tested 
assembly object file that can automatically retrieve 
and decompress any file which was previously compressed 
with SBox. 


TFold ; (Time Fold) An Amiga-based utility program for 
developers that allows the loading of IFF-Anim format 
files for recompression. The ideal goal is to allow 
animation at the highest resolution and rate from the 
CD-ROM drive. Standard video is 30 frames per second. 
This would mean that each picture must be compressed to 
5K given the 150K/sec transfer rate of the CD-ROM. 
TFold would offer those functions that are needed to 
obtain the best compression. (see Exhibit B) 


Tplay.o ; (Time Play) An object module provided to cCDTV 
developers for use in playing TFolded animations. 


It is my understanding that Commodore would be given an 
indefinite non-excusive license to SBox and Debox.ROM. SBox will be 
given by Commodore to CDTV developers as part of the standard 
developer package. DeBox.ROM would be put into the ROMs. These ROMs 
would be put into CDTV and into a special board that would allow 
Amiga owners to access CD-ROM technology. 


TFold and TPlay would be supplied by SSI to Commodore for $1,000 
per unit. Commodore would in turn sell the TFold kit to cDTV 
developers for "x" price (assuming Commodore wishes to make a profit). 
TFold would allow CDTV developers a substantial increase in control 
over animation than is normally accessible using tools currently on 
the market. 


It most likely would be best if you were to call me so that we 
could discuss the aspects of the contract that are in question. The 
above summary should provide’ a good (but simple) understanding of what 
we are supplying. I look forward to your call. 


Truly, 


Reichart Von Wolfsheild, Pres 


-BXHIBIT A 
The following is a print out from SBox that allows you to see how 
the CLI driven program functions. 


SBox! V.02 MC680x0 - File Compressor 

Written by William A. Ware 

Designed by R. K. Von Wolfsheild. 

Copyright 1990, Silent Software, Incorporated. 
*** This program may not be freely distributed *** 


Usage: SBox [ -<opt> ]...<file> [ TO <outfile> } 


Where <opts> ::2 {Pi 7 !S5 !/!B! xX} 
<file> ::= an input file 
<outfile> ::= an output file 


Valid options are: 


Picture; must be in IFF format. 

Text; expected to be a standard ASCII file. 
Sound; can be raw or IFF. 

Binary; can be object or executable. 

Try extra-hard to compress. 

Suppress copyright information. 
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Notes: 


If no options are given, SqueezeBox defaults to "=p", 
picture. If the file is found to not be a standard IFF picture 
SqueezeBox will run a generic compression over the file. 
Multiple "-x" options can be used to find optimum compression. 
Each additional "-xX" will result in longer compression times. 
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From carl Wed Jul 11 23:15:11 1990 

Received: by cbmvax.cbm.commodore.com (5.57/UUCP-Project/Commodore Jan 13 1990) 
id AA10344; Wed, 11 Jul 90 23:15:09 EDT 

Date: Wed, 11 Jul 90 23:15:09 EDT 

From: carl (Carl Sassenrath - Special Projects) 

Message-Id: <9007120315.AA10344@cbmvax.cbm.commodore.com> 

To: gail 

Subject: Duties 

Status: R 


x*x* Job Descriptions and Duties *** 


Carl Sassenrath 

CDTV System Software Project Manager: 
Responsible for producing CDTV System Software for ROM. 
Duties: schedule, manage and oversee work done by other 
members of the system software team. 


CD ISO File System: 
Develop an ISO 9660 file system for CDTV. 
Duties: design and implement Amiga Handler for ISO File System, 
develop bootstrap for new file system, document use, provide 
initial testing of FS. 


CD Device Driver: 
Develop the device driver for CDTV. 
Duties: design and implement Amiga Exec Device for CDTV CD-ROM 
and CD-DA. Document use. Initial testing. Invent new multimedia 
transfer method, CD-XL. 


Non-volatile Memory Library: 
Develop NVRAM memory manager and access library. 
Duties: design manager and access library. Implement if 
no other programmers are available. 


Hardware Development: 
Contribute to and test CDTV Hardware. 
Duties: test, debug, and contribute to the hardware design, 
write system test code,. suggest and verify important changes. 


First Draft Documentation: 
Provide first pass at documentation for Guy Wright. 
Duties: write up abbreviated specs, create example code 


Mike Lehman (suggest $75/hr max) 
Display Object Controller (DOC): 
Develop the display object controller for supporting 
CDTV resident user interfaces and programs. 
Duties: design and implement DOC library, initial testing, 
document use, provide examples ; 


CD-Audio Player: 
Develop CD-Audio player for CDTV. 
Duties: design and implement player, perform initial testing, 
internal documentation. 


CD+G Player: 
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Develop CD+G driver/player/translator for CDTV. 

Duties: design and implement CD+G low-level handler, 

and high-level player, perform initial testing, internal 
documentation. 


Other Resident Application Control Models: 
Develop function of Resident Applications. 
Duties: design and implement low level control of 
CD-Audio player, CD+G, preferences, and startup 
screen. Does not include user interface. 


Maurice Meredith (suggest $50/hr max) 

CD-Audio Player: 
Assist with implementation of CD-Audio player. 
Duties: implement function of player to Mike’s specifications, 
perform testing. 


CDTV Software Testing: 
Responsible for testing all ROM features of CDTV. 
Duties: setup first-stage testing for device driver, 
file system, CD-Audio, display object controller, etc. 


Reichart Von Wolfshield (suggest fixed rate total) 
Decompression Library: 
Develop decompression library for CDTV. 
Duties: design and implement decompression library for 
Amiga pictures, sound, text, binary and animation. 
Animation should support video styles: cartoon, 
digitized, and computer generated. Full testing, 
documentation, and program examples. 


Standard Compression Tools: 
Develop compression tools for CDTV. 
Duties: design, implement, test, and document tools 
to support compression of data for above decompression 
library. 


Resident User Interface: . 
Create graphics/images for CDTV resident applications. 
Duties: layout, balance, color, and design graphics 
and interaction for all screens residing in ROM. 
Organize initial and consumer testing. Coordinate with and 
consult CDTV User Interface design group (Compagna et.al.) 


Bob Burns "Kodiak" (suggest $85/hr max) 

General Amiga Consultant: 
Provide general low-level Amiga Consulting. 
Duties: review and comment on system code related to CDTV. 
Make suggestions, revise, and test code as needed. Check 
interface with input devices and CDTV accessories. 


Non-volatile Memory Library: 
Implement NVRAM memory library. 
Duties: refine and implement NVRAM manager and access library. 
Fully test with internal and external (memcard) memories. 
Revise documentation, provide examples. 


brought to you by 


andy finkel 


